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INTRODUCTION 



Mountain Hardware T s ROMPLUS+ is a powerful addition to your Apple 
II*- computer. ROMPLUS+ has room for six of the 2316 type ROM's, 
or the 2716 EPROM. With each 2316 chip holding 2K bytes of 
memory, ROMPLUS+ has the capacity of 12K bytes of read only 
memory. 

Whether your applications of the Apple II are for business, 
education, research, or juat fun, eventually you will discover a 
set of programs that you use constantly. Examples are special 
peripheral drivers, utility routines, and data collection 
programs. You may access these programs on the ROMPLUS+ board as 
soon as you turn your Apple II on. 

Additionally, ROMPLUS+ provides 255 bytes of RAM which may be 
activated or deactivated under program control. The on-board 
control ROM simplifies your program selection. You need only 
type a few keystrokes to run any program on ROMPLUS+. The 
control ROM relieves the burden of remembering many different 
addresses. ROMPLUS+ also has two TTL level inputs, and these are 
available for any user application. For example, an option on 
Mountain Hardware's Keyboard Filter ROM uses one of these inputs 
to monitor the shift key on the Apple II 's Keyboard. 

This manual is a user's manual for ROMPLUS+. In this manual, we 
cover installation, hardware features of ROMPLUS+, using the 
ROMPLUS+, and writing your own PROMs. 



*Apple II is a trademark of Apple Computer, Cupertino, CA. 
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INSTALLATION 



install ROMPLUS+ simply follow these instructions: 

1. Turn off the power switch at the back of the 
Apple II. The removal or insertion of any card 
with power on could cause severe damage to both 
the computer and ROMPLUS+. 

2. Remove the cover from the Apple II by pulling 
up on the cover at the rear edge. 

3. Now choose an Apple II slot number. Slot 
number should never be used as it is reserved 
for Apple's language cards. In general, 
we recommend that you install ROMPLUS+ into a 
slot immediately below the disk controller 
card. For example, if the disk is in slot #6, 
place ROMPLUS+ into slot #5. The only restric- 
tion is that you may not place ROMPLUS+ into 
slot number 0. 

4. Plug R0MPLUS+ into the slot you have chosen. 
Make sure the board is firmly seated in the 
socket. 



5. 



Replace the cover on your Apple II and turn on 
your computer. 



Chapter 1 

HARDWARE FEATURES 



General 



In this section, we discuss in detail the hardware features of 
ROMPLUS+. The four basic parts are the ROM sockets, the RAM, the 
TTL inputs and the control ROM. 

The ROMPLUS+ board is shown in Figure 1. This figure gives the 
layout of the board f s features. 
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FIGURE 1. 



ROM Space 



ROMPLUS+ has six 24-pin sockets located on the left side of the 
board. These sockets accept the 5 volt 2316 type of ROM chips, 
with each chip holding 2048 bytes. A pin for pin compatible 
cEPROM, such as the 2716 may also be used in the ROM sockets. 

All of the ROM chips are mapped into the $C800-$CFFF memory 
address space, but only one chip is mapped at any one time. If 
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your application program is larger than 2048 bytes, do not worry. 
There is a scheme for switching control from one chip to another 
chip. This scheme, plus information for creating your own chips, 
is given in the Advanced Programmers Information chapter. 



RAM Space 



R0MPLUS+ has 256 bytes of read-write memory (RAM) on-board. This 
RAM may be activated or deactivated x under program control. When 
activated, the RAM maps into the $CF00-$CFFE memory address 
space. Notice that only 255 bytes are available. The last byte 
at location $CFFF may not be used. This is because of the Apple 
II f s peripheral convention which deactivates all peripheral 
boards when memory address $CFFF is referenced. Also, when the 
RAM is active, the top 256 bytes of the selected ROM chip are not 
available. This is because the RAM maps into the same space used 
by the ROM chip. If your ROM chip uses all of its 2048 bytes, 
simply deactivate the RAM. See chapter 5 for information on the 
control word used to activate or deactivate the RAM. 

The RAM will retain its contents whether R0MPLUS+ is active or 
not in use. The RAM, of course, loses its contents when power is 
switched off. 

The RAM provides the ROM chips with their own private storage 
area. This will help to minimize memory conflicts. However, the 
RAM may be used by any program in the Apple II. 

We recommend that the RAM be allocated in the following way: 

Address Use 

$CF00-$CF03 
$CF04-$CF5F 
$CF60-$CF7F 
$CF80-$CF9F 
$CFA0-$CFBF 
$CFC0-$CFDF 
$CFE0-$CFFE 
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TTL Inputs 



A four pin connector on ROMPLUS+ provides two TTL level inputs 
and two ground pins. A matching four pin plug with wire is 
available from Mountain Computer. Order Part No. MHP-X021. 
Price $3.00. 



Pins 2 and 3 are grounded. Pins 1 and 4 are the TTL inputs. The 
inputs are held high by pull-up resistors. Therefore, an unused 
input will be read as a high level, or a "1". The TTL inputs are 
read through the control word. Chapter 5 has more information on 
the control word. Pin 1 on the connector maps to bit 4 of the 
control word. Pin 4 on the connector maps to bit 5 of the 
control word. 



Control ROM 



The control ROM provides the "intelligence" which makes R0MPLUS+ 
easy to use. It controls input and output functions and allows 
for easy ROM socket selection and entry point selection. Many of 
its features are in the next chapter, Using R0MPLUS+. 

The control ROM occupies the memory address space $CN00-$CNFF, 
where N is the slot number. The ROM is supplied with power 
whenever it is addressed. This results in a power-saving. 



12 3 4 
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Right 
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USING ROMPLUS+ 



This chapter covers the basic information you need for typical 
operation of ROMPLUS+. This chapter should be read carefully. 
We will cover such topics as selecting ROMPLUS+, activating RAM, 
ROM socket selection, and entry-point selection. 



Activating ROMPLUS+ 



ROMPLUS+ is a peripheral that is activated in the same manner as 
other Apple II peripherals. From BASIC, ROMPLUS+ is turned on by 
a ,f IN#n ff or "PR#n" command, where n is the slot number. From 
the monitor, a "nCTRL-K" or "nCTRL-P" command will turn on 
ROMPLUS+. If you are running BASIC under DOS, use the regular 
DOS procedure of printing a CTRL-D followed by the command. 
Whenever the board is activated, the RAM is also activated. 

The board is deactivated by using both the "IN#0" and "PR#0" 
commands. Hitting the "RESET" key will also deactivate ROMPLUS+. 
If another peripheral card is accessed via the "IN#n" or "PR#n" 
commands, ROMPLUS+ will be deactivated. Of course, any reference 
to address $CFFF will deactivate ROMPLUS+ (or any other 
peripheral board). 

Once ROMPLUS+ has been activated, all input and output operations 
are vectored through the control ROM. This is transparent to the 
user, i.e., nothing seems different. However, the control ROM is 
looking for one of two special command characters. If the 
character passed on input or output is not a special command 
character, it is passed to the input or output routine. If the 
character is a command, then the next two characters are 
interpreted as parameters of the command. 
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Commands 



The two command characters are CTBL-SHIFT-M and CTRL-SHIFT-N 
(ASCII codes $9D and $9E respectively). You may obtain these 
characters by pressing the CONTROL, SHIFT, and letter keys 
simultaneously. These characters were chosen to minimize typing 
accidents. 

The syntax of the commands are: 

CTRL-SHIFT-M<ROM socket #><entry point>. 
CTRL-SHIFT-N<ROM socket #x entry point>. 

There are no spaces between the command character, the ROM socket 
#, and the entry point. The brackets are not entered. No return 
is necessary after the command. Notice the command is three 
characters long. 

ROM socket number is a value from to 6 which specifies which 
ROM socket you want to select. Only one ROM socket is active at 
one time, but one ROM socket may call another ROM socket. 
Selecting chip number will deactivate the current ROM socket 
without deactivating ROMPLUS+. If an invalid ROM socket is 
selected, the "bell" will beep. 

Entry point is a letter, starting with A, and ending with a 
letter depending on the particular ROM chip selected. The number 
of entry points on .any ROM is determined by information on that 
particular ROM. The first entry point is always "A", the second 
entry point is ff B fl , and so on. If an illegal entry point is 
specified, the bell will beep. The documentation accompanying 
any commercially available ROM for ROMPLUS+ will detail the valid 
entry points of that ROM. If you write your own ROM, you will 
place a table of entry points on the ROM. The number of entry 
points determines the valid entry point characters. More 
information on writing your own ROM chips is in the next 
chapter. 
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CTRL-SHIFT-M 

This command selects one of the two operating modes of ROMPLUS+. 
The CTRL-SHIFT-M command will let the selected ROM gain control 
every time a character is inputed or outputed.. When this command 
is issued, all subsequent input and output is vectored through 
two hooks which are located on the selected ROM. 

Recall that when ROMPLUS+ is activated, the input and output is 
vectored through the control ROM. This means that when a 
character is input, a call is placed to the control ROM which 
calls the input driver. The control ROM inspects this character 
and then passes it along to the program requesting input. 
Similarly, on output of a character, a call is placed to the 
control ROM, which inspects the character and then calls the 
output driver. Wheaever ROMPLUS+ is not active, input and output 
are not vectored through the control ROM.- Instead, they are 
vectored to the normal input and output drivers of the Apple. 

When the CTRL-SHIFT-M command is given, the input and output are 
now vectored through the input and output hooks on the selected 
ROM. Normally, these input and output hooks point to locations 
within the selected ROM. More information about the hooks is in 
the next chapter. 

In general, all of the hooks and vectors are transparent to the 
user. When ROMPLUS+ is deactivated, I/O vectors through the 
normal Apple II I/O drivers. When R0MPLUS+ is active, I/O is 
vectored through the control ROM. When a CTRL-SHIFT-M command is 
given, all subsequent I/O is vectored through the selected ROMs* 
I/O hooks. The ROMs' I/O hooks are located in the branch table. 
More information about the branch table is in the next chapter. 

The net effect of the CTRL-SHIFT-M command is that the selected 
ROM gains control on every input or output character. This 
continues until ROMPLUS+ is deactivated, or the particular ROM is 
deactivated. Examples of the type of program which use this mode 
of operation are printer drivers, or Mountain Hardware's Keyboard 
Filter. These programs need to execute with every input or 
output operation. 



CTRL-SHIFT-N 



This command selects one of two operating modes of ROMPLUS+. The 
CTRL-SHIFT-N command will pass control to the selected ROM 
program. This program is executed immediately and then control 
returns. If this command was printed as part of a BASIC program, 
then control returns to BASIC. If this command was entered 
immediately from the keyboard, then control returns to the 
keyboard. 
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A program executed by the CTRL-SHIFT-N command in one ROM may 
execute another ROMPLUS+ program in another ROM by outputting 
anothr CTRL-SHIFT-N command. However, a program executed by the 
CTRL-SHIFT-N command may not output a CTRL-SHIFT-M command. In 
the former case, the control ROM keeps track of control. In the 
later case, the control ROM keeps track of control. In the later 
case, we have a situation which is logically meaningless. It 
does not make sense to have a routine type of program calling a 
special driver type program. 

It does make sense however, to have a driver type program 
(activated by CTRL-SHIFT-M) call upon a routine type program 
(CTRL-SHIFT-N). For example, a program such as Keyboard Filter 
might call upon a routine on another ROM. It would output a 
CTRL-SHIFT-N command. The control ROM keeps track of the calling 
ROM and the called ROM. It returns control to the calling ROM 
when the called ROM returns. 



Selecting RAM 



Any time R0MPLUS+ is activated, or any ROM is activated via the 
CTRL-SHIFT-M or CTRL-SHIFT-N commands, the on-board RAM is 
activated. Whenever this RAM is active, the top 256 bytes of the 
selected ROM are not available. If your program uses the top 256 
bytes of the ROM, you must deactivate the RAM before the code is 
executed. Otherwise, the computer will read the contents of RAM 
and interpret that data as instructions. This usually results in 
disaster. It is necessary to reactivate RAM before returning 
control. The next chapter contains a few routines used for con- 
trolling the state of the RAM. 



Notes 



The control ROM on ROMPLUS+ makes use of two locations in memory 
normally used by the monitor. These two locations are $3A and 
$3B. As a result, whenever ROMPLUS+ is active, the monitor ff L tf 
command for disassembly and the Apple II mini-assembler will not 
work properly. To restore these commands, deactivate ROMPLUS+. 

The Apple II peripheral scheme states that all ROM's in the 
$C800-$CFFF space must be de-selected whenever $ CFFF is 
referenced. Therefore, take care that your programs never 
reference location $CFFF. 



2 -it 



Chapter 3 

ADVANCED PROGRAMMER'S INFORMATION 

This chapter contains information for the advanced use of 
ROMPLUS+. The sections about the control word and the control 
ROM should be read by anyone using ROMPLUS+. The other sections 
about the branch table, preparing your ROM, and programs greater 
than 2K bytes are intended for the user that will prepare their 
own ROM chip for use in ROMPLUS+. However, anyone using ROMPLUS+ 
will benefit from the information in those sections. 



The Control Word 



The features of ROMPLUS+ are controlled by the control word. The 
control word is a read/write word located at a slot dependent 
memory address. The address of the control Word is $C080+$N0 (or 
-16256 + 16*N from BASIC), where N is equal to the slot number. 
The following table summarizes: 

Slot # Hex Address BASIC Address 



1 


$C090 


-16240 


2 


$C0A0 


-16224 


3 


$C0B0 


-16208 


4 


$C0C0 


-16192 


5 


$C0D0 


-16176 


6 


$C0E0 


-16160 


7 


$C0F0 


-16144 



A write to the control word location may be used to select a ROM 
socket, activate or deactivate the board, or activate or 
deactivate the RAM. The function of the particular bits are 
described below: 

control word 

Bit 7: This bit controls the RAM. If a "0" is written, 

the RAM is deactivated. If a "1" is written, 
the RAM is activated. 

Bit 6-4: Unused. 



Bit 3: This bit controls the board. If a "0" is 

written, the R0MPLUS+ is deactivated. If a "1" 
is written, the board is activated. 
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Bit 2-0: These bits select the ROM socket to be enabled. 

Bit two is the most significant bit of the 
value. If the value=0, then none of the ROMs 
are enabled. If set from 1 to^6, the corresp- 
onding ROM is enabled. The value should never 
equal 7. 



A read to the control word is used to check the status of the 
RAM, find the currently enabled ROM socket number, or to sense 
the value of the two TTL inputs. The function of the particular 
bits are described below. 



MelsUlsUMol 

Bit 7: 



This bit reads the 



If equal 



"0", then RAM is deactivated. If equal to "1" 



to 

9 



control word 

status of RAM. 

9a 

then RAM is active. 
Bit 6: Unused. 
Bit 5: TTL input from pin 4. 

Bit 4: TTL input from pin 1. 

Bit 3: Unused. 

Bit 2-0: These bits indicate which Rom socket is current- 
ly enabled. The value is determined the same 
way as the bits 2-0 of the written control word. 

We next examine several programming examples of control word use. 
First, if we wish to activate R0MPLUS+ and select ROM socket 
number one, we use these machine language instructions: 



LDA #$89 
STA $C080,X 



: RAM active, board active, ROM #1 
:Write control word 



In that example, and in the examples to follow, we assume that 
the X register contains the slot number (1-7) multiplied by 16. 
This is the standard convention for slot independent I/O on Apple 
II. 

To do the same thing in BASIC, we use a statement like this: 
POKE -1 6256+1 6*SL0T, 137 
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Now suppose you wish to activate ROMPLUS+, deactivate the RAM, 
and select ROM #5. You would do one of the following: 

LDA #$0D :Deactivate RAM, activate ROMPLUS+, select 

ROM #5. 

STA $C080,X :Write control word 
or POKE -16256+16*SL0T, 13 

If you wish to toggle the state of the RAM (i.e., turn off when 
it is on and turn on when it is off), you would use this code: 

LDA $C080,X :Read control word 
EOR #$80 : 
ORA #$80 : 

STA $C080,X :Write control word 

From BASIC, use these statements: 

S= (PEEK(-1 6256+1 6*SL0T) +128) MOD 256 
IF S MOD 16<8 THEN S=S+8 
POKE -16256+16*SL0T,S 

It is necessary to set bit 3 so that you don't deactivate 
R0MPLUS+. This final example will test the TTL input at bit 4. 

LDA $C080,X :Read control word 

BIT #$10 :Mask bit #4 

BNE :If bit is set 

BEQ :If bit is clear 

In BASIC: 

IF (PEEK(-16256+16*SL0T)M0D 32)>15 THEN BIT IS SET 

Remember that when writing the control word, bit 3 must be set to 
activate R0MPLUS+. Even if R0MPLUS+ is already active, bit 3 
must be set if you do not want to deactivate R0MPLUS+. 

If a read of the current ROM chip yields ROM socket number zero 
as the active ROM, then no ROM is active. If R0MPLUS+ is not 
active, then the current ROM chip will read as ROM socket number 
zero. 



Control ROM 



The control ROM provides "intelligence" for R0MPLUS+. It is a 
256 byte memory which controls the functions of R0MPLUS+. A 
complete source listing is in the Appendix. In this section, we 
will detail memory usage and entry points of the control ROM. 
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The control ROM uses two bytes of memory in the zero page. These 
two locations are $3A and $3B. These two locations were chosen 
to take advantage of the monitor indirect jump at $FEBC. The use 
of the two page zero memory locations ($3A & $3B) causes a memory 
conflict with two of the monitor's commands. As mentioned 
erlier, when ROMPLUS+ is activated, the mini— assembler and the 
disassembler will not work. 

Additionally, the control ROM uses seven bytes in the screen 
space. These locations are slot dependent, and they are 
summarized in the following table. 



Symbolic Name Byte Location Usage 

CHIP $478+SLOT# Contains active BOM socket # 

for CTRL-SHIFT-M commands 



MODE 
WHICH 



$4F8+Slot# 
$578+Slot# 



Used to parse commands 

Used to hold the entry point 
letter 



CURCHIP 

TCHIP 
SO 

MSLOT 



$5F8+Slot# 

$678+Slot# 
$6F8+Slot# 

$7F8 



Contains number of most rec- 
ently used ROM socket 



A scratch location 



Contains the value 
# * 16) 



Contains the 
where N=Slot#) 



(Slot 
value ($CN 



The control ROM has three entry points. Assuming that N = Slot 
number, the entry points are: 

$CN00 Initial entry point, used when ROMPLUS+ is 

activated. It will initialize variables 
and I/O hooks. 



$CN06 Output entry point. Vector here to output 

a character. 

$CN08 Input entry point. Vector here to input a 

character. 
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The Branch Table 



Every ROM that is to be used on ROMPLUS+ must have a branch table 
at the beginning of the ROM. The branch table allows the user to 
select an entry point into the ROM by using just a letter to 
designate the entry point. A summary of the branch table is as 
follows: 

Address 



$C800 Address of output hook routine 

$C8'02 Address of input hook routine 

$C804 Value which indicates length of Branch 

table 

$C805 Address for entry point #1 

$C807 Address for entry point #2 



$C805+(2*(n-1 ) ) Address for entry point #n 



All of the addresses are 2 bytes long, with the low order byte 
first. All branch tables must have at least one entry point. 
With only one entry point, the branch table would end at $C806 
and the value of the byte at $C8.0 4 would be $07. The value 
contained at $C804 is the total number of bytes in the branch 
table. Therefore, if there are "N" entry point address, the 
value of $C804 is (2*N+5). 

The input and output hook address ($C800 and $C802) are used by 
the CTRL-SHIFT-M command. $C800 contains the address of the 
routine to be called every time a character is to be outputed. 
This output hook address is usually the address of a routine on 
that particular ROM. $C802 contains the address of the routine 
on a particular ROM to be called every time a character is to be 
inputted. All character I/O routines should end with a return 
from subroutine instruction. If the ROM that you write does not 
use the CTRL-SHIFT-M command, then these I/O hooks will not point 
to a routine on the ROM. Instead, you should use the addresses 
of the standard Apple I/O drivers. The output hook, $C800, 
should contain the address $FDF0, with the low Oder byte first. 
Likewise, the input hook, $C802, should contain the address 
$FD1B. These I/O hooks on the ROM must always point to valid I/O 
routine addresses. 

The branch table is the only requirement for ROM's. The 
application program's code may begin immediately after the branch 
table. 
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Writing Your Own ROM 



There are a few things you should remember when writing your own 
ROMs, First, your program should never reference location $CFFF. 
Any reference to that address will disable all memory that maps 
into $C800-$CFFF. If you do reference that address, you will 
disable ROMPLUS+. 

The slot number of ROMPLUS+ may be found by your program by 
reading $7F8. It will contain the value $CN where N is the slot 
number. Location $6F8+N contains the value $N0. 

The control ROM makes sure that RAM is active whenever a ROM 
socket is selected. If your program must deactivate the RAM, it 
must reactivate RAM before it finishes executing. 



Programs On Two ROMs 



The 2K bytes of storage on each ROM is large enough for all but 
the larger programs. If you have an application program that is 
larger than 2K bytes, there is a scheme allowing you to use two 
ROMs in conjunction. 

ROMPLUS+ will map any one of the six ROMs into the $C800-$CFFF 
address space at one time. If you simply had the first ROM write 
a control word which switches the ROM socket number to the new 
ROM socket number, your program will immediately switch to the 
other ROM. This usually blows up the program. 

One solution to this problem is to write a subroutine dispatching 
subroutine, and place this subroutine into identical addresses on 
the two ROMs. This way, you enter the subroutine dispatching 
subroutine on the first ROM, the switching of ROM occurs, and the 
dispatching routine continues on the second ROM, because the 
identical addresses contain identical code. 

Here is the code which will do the task: 

*The A register contains the ROM socket number 

*you wish to use. The Y register contains a 

*value which determines which routine is run (routine 

^number *2). You must preserve the X register. 

MSLOT EQU $7F8 

CONTROL EQU $C080 

CHIPNUM EQU $0 

SUBADDR EQU $1 
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CHIP.CALL 



At this point, 
specified by Y. 



STA 


CHIPNUM 


:save ROM number 


LDX 


MSLOT 


:get $CN 


LDA 


$638, X 


:get $N0 


TAX 




:x contains value $N0 


LDA 


CONTROL, X 


:get control word 


ORA 


#$08 


:turn on activate bit 3 


PHA 




:save so we can restore 






later 


AND 


#$F8 


:set ROM number to zero 


ORA 


CHIPNUM 


:or in new ROM number 


STA 


CONTROL, X 


rwrite to control word 


we 


are now on 


the other ROM. Call routine 



LDA 


SUBTABLE, X 


STA 


SUBADDR 


LDA 


SUBTABLE+1 ,y 


STA 


SUBADDR+1 


JSR 


CALLSUB 


PLA 




STA 


CONTROL, X 


RTS 




JMP 


(SUBADDR) 


DA 


SUB1 


DA 


SUB2 



CALLSUB 
SUBTABLE 



It is necessary for this 
addresses on the two ROMs, 
may be located anywhere 
possible memory conflicts, 
of $1 and $2. 



:get low byte of address 
:and store here 
:get high byte of address 
:and store here 
: indirect subroutine call 
:return, get old state 
: restore old ROM 
:return out of this routine 
: indirect jump to routine 
:table of routine addresses 
:low byte first, high byte 
second 



routine to be located at identical 
Otherwise it will not work. SUBADDR 

in memory as long as there are no 
We recommend the page zero addresses 



The program "CHIPCALL"' is a subroutine, and should be called with 
the "JSR" instruction. Before you call the subroutine, set up 
the "A" and "Y" registers. The value of the X register must be 
preserved. 
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REFERENCE 



This chapter is a concise description of the hardware and 
software of ROMPLUS+. It is intended to serve as a reference 
section only. 

The hardware features of ROMPLUS+ are: 

1. Sockets for six 2K ROMs (2316) or EPROMs (2716). 
Total ROM capacity is 12K bytes. ROM is selected by 
software. 

2. 256 bytes of RAM which can be enabled or disabled under 
software control. 

3. Two TTL levels inputs which are held high by pull-up 
resistors. The inputs are read from the control word. 

4. A 256 byte control ROM which controls the operation of 
ROMPLUS+. 

The software features of ROMPLUS+ are summarized below: 

1. ROMPLUS+ is activated by the "IN#n" or "PR#n" commands 
from BASIC. ROMPLUS+ is deactivated by both "IN#n" 

and "PR#n" commands, or by RESET, or by referencing 
location $CFFF. 

2. There are two modes of operation available. These 

modes are selected by these commands: 

a) CTRL-SHIFT-M: This mode will run the selected ROM 

program every time a character is 
inputted or outputted. 

b) CTRL-SHIFT-N: This mode will run the selected ROM 

program immediately, and then 
return control to the calling pro- 
gram. 

3. The command structure is: 

CTRL-SHIFT-M<ROM socket numberxentry point> 
CTRL-SHIFT-N<ROM socket numberxentry point> 

The "CTRL-SHIFT- letter" character is typed by holding 
down the CONTROL and SHIFT keys while typing either "M" 
or "N". 

<ROM socket number> is a value from to 6, and selects 
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a ROM socket, ROM socket zero will disable all the 
ROMs without disabling ROMPLUS+. <entry point> is a 
character used to select the entry point into the ROM. 

All ROMs must have at least one entry point. Entry 
point A is the first entry point, B is the second entry 
point, etc. 

There are no spaces between the command character, 
the Ram socket number, and the entry point character. 
The brackets are not typed. 

4. RAM ( is enabled and disabled by bit 7 of the control 
word. The top 256 bytes of any selected ROM is not 
available when RAM is enabled. If RAM is disabled by 
any ROM, then it must be enabled before the ROM 
returns. 
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Appendix A 

CONTROL ROM SOURCE LISTING 



General Information 

The following pages contain the Control ROM Source listing. Once 
ROMPLUS+ has been activated, all input and output operations are 
vectored through the control ROM, This is transparent to the 
user. The Control ROM is looking for one of two special command 
characters ( CTRL-SHIFT-M or CTRL-SHIFT-N. ) If the character 
passed on input (or output) is not one of these special commands, 
then it is passed on to the input routine. If the character is 
one of the special commands, then the next two characters are 
interpreted as parameters of the Control ROM command. 

NOTE 

The Control ROM makes use of two locations in memory 
that are normally used by the monitor. These two loca- 
tions are $3A and $3B. Whenever the R0MPLUS+ card is 
active, the monitor ff L u command for disassembly and the 
Apple II mini-assembler will not work properly. 
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1 * PPT ON 

2 * 

+****++**+*++*++******+***+****.+ 

4 * 

5 * CONTROL PROM FOR MOUNTAIN 

6 * HARDWARE ROM BOARD 

7 * 

8 * BY ANDY HERTZFELD 

9 * 

18 * <C> 1979 BY ANDY HERTZFELD 

11 * 

12 * 

13 * VERSION 1. 6, 4/16/79 

14 * 

it:******************************* 

16 * 

17 * EQUATES FOR SCREEN SPACE 



18 


* 






•1 o 

±y 


MSLOT 


EQU 


Irro 


£0 


CHIP 


EQU 




21 


MODE 


EQU 


*438 


22 


WHICH 


EQU 


*4B8 




CURCHIP 


EQU 


*538 


24 


TCHIP 


EQU 


$5B8 


25 


SO 

-±. 


EQU 


*638 


26 

ic:7 

28 


* MISC EQUATES 

-A- 




29 


IORTS 


EQU 


$FF58 


39 


CSW 


EQU 


*36 


31 


STACK" 


EQU 


$100 


32 


RDKEY 


EQU 


*FD1B 


33 


CHRROUT 


EQU 


$FDFO 


34 


BELL 


EQU 


SFBDD 


35 


CONTROL 


EQU 


$C080 


36 


ENTRIES 


EQU 


*C800 


S i' 


CHIPLIM 


EQU 


*C884 




GOVECTOR 


EQU 


fFEBC 


39 


PC 


EQU 


*3fl 


48 


CTLfl 


EQU 


*9D 


41 


CR 


EQU 


*8D 


42 


CTLB 


EQU 


$9E 


43 


SCTLA 


EQU 


*3R 


44 


* 






45 


* 






46 




ORG 


*630O 


47 




OBJ 


$6300 
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48 + 

49 * 

56 * WE USE 3 DIFFERENT ENTRV 

51 * POINTS: "FIRST'S FOR THE 

52 * INITIAL ENTRV FIND "OENTRV" 

53 * AND "I ENTRV" FOR THE OUTPUT 

54 * AND INPUT RE-ENTRIES. THE 

55 * C AND V BITS ARE USED TO 

56 * REMEMBER WHICH ENTRV OCCURED. 

57 * 



bi00 


2C 


58 


FF 58 


FIRST 


BIT 


IORTb bET VFLHb FUR INITIHL 


6303: 


38 




59 




SEC 


MAKE INITIAL ENTRV OUTPUT 


6304 


70 


04 


60 




BVS 


ENTRV ALWAVb THKEN 


6306 


38 




61 


OENTRV 


SEC 




6307 


30 




62 




HEX 


90 TRICK TO SAVE A BVTE 


6308 


18 




63 


I ENTRV 


CLC 


; HIDE AS BRANCH OFFSET 


6303 


B8 




64 




CLV 










65 


* 












66 


* COMMON 
* 


ENTRV 


POINT 


630A 


48 




67 
68 


ENTRV 


PHA 




630B 


8A 




69 




TXfl 




638C 


48 




70 




PHA 




630D 


98 




71 




TVA 




630E 


48 




72 




PHA 




630F 


08 




73 




PHP 










74 


* 












75 


* NOW WE 


MUST 


Find out what slot 








76 


* WE "RE 


IN. THIS IS ACHIEVED BV 








77 


* MAKING 


A DUMMV JSR WHICH WILL 








78 


* LEAVE 


OUR ADDRESS ABOVE THE 








79 


* STACK. 


INTERRUPTS MUST BE 








80 


* DISABLED. 










81 


* 






6310 


: 78 




82 




SEI 




6311 


: 20 


58 


FF 83 




JSR 


IORTS DUMMV JSR 


6314 


BA 




84 




TSX 




6315 


: 68 




85 




PLA 




6316 


: 68 




86 




PLA 




6317 


: 68 




87 




PLA 




6318 


: 68 




88 




PLA 


:■ RECOVER INPUT CHARACTER 


6319 


: A8 




89 




TAV 


; AND KEEP IN V REGISTER FOR 


631A 


: CA 




90 




DEX 




631B 


: 9A 




91 




TXS 




631C 


: 68 




92 




PLA 


> GET *CN FROM STACK 


631D 


: 8D 


F8 


87 93 




STA 


MSLOT 


6320 


. AA 




94 




TAX 


; SLOT # IN X 


6321 


. OA 




95 




ASL 




6322 


: 0A 




96 




ASL 




6323 


: 0A 




97 




ASL 




6324 


: ©A 




98 




ASL 




6325 


: 9D 


38 


06 99 




STA 


S0,X 


6328 


: BD 


B8 


03 100 




LDA 


CHIP, X 


632B 


: 9D 


~:8 


05 101 




STA 


CURCHIP, X 








102 


* 







NOW 
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632E 
632F 
6330 



634A 
634C 
634F 



183 * 

104 * NOW RECOVER STATUS AND GO TO 

165 * THE PROPER ROUTINE ACCORDINGLY 

106 * 

28 10? PLP > RE-ENABLE INTERRUPTS 

08 108 PHP ; SAVE STATUS 

50 16 109 BVC REENTRY 

110 * 

111 * THE FOLLOWING CODE IS FOR THE 

112 * INITIAL ENTRY ONTO THE BOARD. 

113 * WE INITIALIZE OUR VARIABLES 

114 * AND SET THE HOOKS TO POINT TO 

115 * THE RE-ENTRY POINT. 

116 * 



6332: 


AD 


F8 07 


117 INIT 


LDA 


MSLOT 


6335 


85 


37 


118 / 


STA 


CSW+1 


6337 


85 


39 


119 


STA 


CSW+3 


6339 


A9 


06 


128 


LDA 


#<OENTRV 


633B 


85 


36 


121 


STA 


CSW 


633D 


A9 


08 


122 


LDA 


#< I ENTRY 


633F 


85 


38 


123 


STA 


CSW+2 


6341 


A9 


00 


124 


LDA 


#*00 


6343 


9D 


B8 83 


125 


STA 


CHIP, X 


6346 


: FO 


35 


126 


BEQ 


RESET 1 



ALWAYS TAKEN 



127 * 

128 * 



129 * WE COME HERE FOR A RE-ENTRY. 

138 * WE CHECK FOR COMMANDS JUST 

131 * ON OUTPUT. AT THIS POINT THE 

132 * CARRY STILL MARKS WHERE 

133 * WE CAME FROM. 

134 * 

6348: BO 07 135 REENTRY BCS OUTHOOK 

136 * 

137 * SET WHICH TO INPUT HOOK 

138 * 

A9 02 139 LDA #*02 

9D B8 04 148 STA WHICH, X 

D8 56 141 BNE VECTOR ALWAYS TAKEN 

142 * 

143 * HERE WE HANDLE THE OUTPUT HOOK. 

144 * WE SET WHICH AND UPDATE THE 

145 * CURRENT CHIP AND THEN GO CHECK 

146 * FOR COMMANDS 

147 * 

6351: A9 00 148 OUTHOOK LDA #$8 
6353: 9D B8 04 149 STA WHICH, X 

150 * 

151 * THE FOLLOWING ROUTINE CHECKS 

152 * FOR THE CHIP INITIALIZATION 

153 * COMMAND. IT IS CALLED ONLY 

154 * ON OUTPUT TO PREVENT THE SAME 

155 * CHARACTER FROM PASSING THROUGH 

156 * TWICE. THE MODE VARIABLE KEEPS 

157 * TRACK OF OUR CURRENT STATE. 
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158 


* 






6356 


98 






159 


COMMAND TVfi 






6357 


BC 


38 


04 


160 


LDV 


MODE, X 




635A 


36 


0F 




161 


BMI 


GETNUM 




635C 


DQ 


29 




162 


BNE 


GETINIT 












163 


* 






635E 


C9 


9D 




164 


CMP 


#CTLfl 




6368 


F0 


04 




165 


BEQ 


SAVEMODE 




6362 


C9 


9E 




166 


CMP 


#CTLB 




6364 


D0 


41 




167 


BNE 


VECTOR 












JLO© 


SAVEMODE STR 


MODE, X 




6369 


F0 


3C 




169 


BEQ 


VECTOR ALWAVS 


TAKEN 










170 


+ 














171 


* PARSE THE NUMBER, CHECKING TO 










172 
173 


+ MAKE SURE ITS FROM 6 TO 6. 




636B 


• 49 


B0 




174 


GETNUM EOR 


#$80 MUST BE I 


>=0 


636D 


C9 


07 




175 


CMP 


#*87 




636F 


: B0 


09 




176 


BCS 


NOGOOD AND < 7 




6371 


IE 


38 


04 


177 


ASL 


MODE, X 




6374 


• 9D 


B8 


05 


178 


STfl 


TCHIP, X 




6377 


D0 


2E 




179 


BNE 


VECTOR ALWAVS 


TAKEN 










180 


* 














181 


* THE FOLLOWING CODE HANDLES 












1 0'~> 
J»OcL 


* ERRORS BY RINGING THE BELL 












183 


+ AND CANCELLING ANV PARTIAL 












184 


* COMMANDS. ] 


[TS IN THIS WEIRD 












185 


* PLACE BECAUSE OF THE 6502 'S 












186 
187 


* RELATIVE ADDRESSING CONSTRAINT. 


6379 


48 








N0G00D2 PHfl 






637fl 


20 


DD 


FB 


189 


NOGOOD JSR 


BELL 












190 


* 






637D 


A9 


00 




191 


RESET LDA 


#$0 




637F 


9D 


38 


©5 


192 


STA 


CURCHIP, X 




6382 


9D 


38 


04 


193 


STA 


MODE, X 




6385 


F0 


20 




194 


BEQ 


VECTOR ALWAVS 


TAKEN 










195 


* 














196 


* HANDLE THE 


SELECTION PARAMETER 










197 


* BUT DON'T ERROR CHECK IT TILL 










198 


* THE CHIP IS ACTIVATED 












199 








6387 


0fl 






200 


GETINIT ASL 


, CflRRV. IS SET 




6388 


E9 


7D 




201 


SBC 


#$7D ,' 2* "A-5 




638A 


9D 


B8 


04 


202 


SETWHICH STA 


WHICH, X 




638D 


fl9 


00 




203 


LDA 


#$0 




638F 


: 9D 


38 


04 


204 


STA 


MODE, X 




6392 


BD 


B8 


85 


205 


LDA 


TCHIP, X 




6395 


9D 


38 


05 


206 


STA 


CURCHIP, X 




6398 


C0 


3fl 




207 


CPV 


#SCTLA 




639fl 


D8 


0B 




208 


BNE 


VECTOR 




639C 


9D 


B8 


03 


209 


STA 


CHIP, X 




639F 


BC 


38 


06 


210 


LDV 


S0,X 




63A2 


09 


88 




211 


ORA 


#$88 




63A4 


99 


80 


C0 


212 


STA 


CONTROL, V 
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213 


* 












214 














215 














216 


* THE FOLLOWING ROUTINE HANDLES 










217 


* THE VECTORING TO CHIP I/O HOOKS 










218 


* FIRST WE ENABLE THE SELECTED CHIP. 










213 


* 




wjri i . 


28 






2^0 


VECTOR PLP 


; RECOVER STATUS 


63fl8: 


BC 


38 


06 


221 


LDV 


S8, X 


63fiB; 


69 


80 


C0 


222 


LDfl 


CONTROL, V 


63fiE: 


48 






223 


PHfl 




63fiF: 


AD 


FF 


CF 


224 


LDfl 


*CFFF DISABLE OTHER 


63B2: 


BD 


38 


05 


225 


LDfl 


CURCHIP, X 


63B5 : 


89 


88 




226 


ORfl 


#*88 


63B7. 


99 


80 


C0 


22? 


STfl 


CONTROL, V 


63Bfl 


68 






228 


PLfl 




63BB 


8D 


02 


CF 


229 


STfl 


*CF02 


63BE 


8C 


03 


CF 


238 


STV 


*CF03 


63C1 


BD 


38 


05 


231 


LDfl 


CURCHIP, X 


63C4 


D8 8E 




232 


BNE 


VECHOOK 










233 














234 


* NO CHIP HAS 


BEEN ACTIVATED VET 










235 


* SO GO TO STANDARD KEVIN OR KEVOUT 










236 


* 




63C6 


fl9 


FD 




237 


LDA 


#>CHAROUT 


63C8 


85 


3B 




238 


STA 


PC+1 




A9 


F0 




239 


LDA 


KCHAROUT 


63CC 


B0 


02 




249 


BCS 


ITSOUTPUT 


63CE 


A9 


IB 




241 


LDA 


tKRDKEV 


63D0 


: 85 


3fl 




242 


ITSOUTPUT STA 


PC 


63D2 


: D8 


12 




243 
244 
245 


BNE 

* 
* 


EXIT ALWAVS TAKEN 










246 


* NOW WE OBTAIN THE PROPER ADDRESS 










247 


* TO VECTOR TO BV INDEXING INTO 










248 


* THE INITIALIZATION TABLE ON THE 










249 


* CHIP. WE STORE THE ADDRESS 










250 


* IN LOCASL RAM AND THEN VECTOR 










251 


* THERE BV AN 


INDIRECT JUMP 










252 


* 




63D4 


: BC 


B8 


04 


253 


VECHOOK LDV 


WHICH, X ; GET INDEX 


63D? 


: CC 


84 


C8 


254 


CPV 


CHIPLIM 


63Dfl 


: B8 


9D 




255 


BCS 


N0G00D2 


63DC 


: B9 


01 


C8 


256 


LDA 


ENTRIES+1, V 


63DF 


: 85 


3B 




257 


STA 


PC+l 


63E1 


: B9 


00 


C8 


-err, 
c •-»««.» 


LDA 


ENTRIES, V 


63E4 


: 85 


3fl 




259 


STA 


PC 



xxxxxx 
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269 + 

261 * NOW WE RESTORE REGISTERS AND GOTO 

262 * THE HOOK ROUTINE. 
262 * 

63E6: 68 264 EXIT PLfi 

63E7: R8 265 TflV 

63E8: 68 266 PLfl 

63E9: flfl 267 TAX 

63EA: 68 268 PLfi 

63EB: 28 BC FE 269 JSR GOVECTOR 

270 * 

63EE: 48 271 PHfl 

63EF: 98 272 TVfl 

63F8: 48 273 PHfl 

63F1: AC 83 CF 274 LDV $CF03 

63F4: RD 02 CF 275 LDfl *CF02 

63F7 : 09 08 276 ORfi #*08 

63F9: 99 88 C8 277 STfl CONTROL/ V 

63FC: 68 278 PLfl 

63FD: A8 279 TflV 

63FE: 68 280 PLfl 

63FF: 68 281 RTS 

282 * 

283 * 

284 * ALL DONE! 

285 * 

— END ASSEMBLY 

TOTAL ERRORS: 00 

256 BVTES OF OBJECT CODE 

WERE GENERATED THIS flSSEMBLV. 
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Located in the Santa Cruz Mountains of Northern 
California, Mountain Computer, (no. is a computer peripheral 
manufacturer dedicated to the production of use-oriented 
high technology products for the microcomputer. On-going 
research and development projects are geared to the continual 

supply of unique, innovative products that are easy to use 
and highly complementary in a broad variety of applications. 




